NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: Butil NLM version 5.15a DOCUMENT ID: TID000067 DOCUMENT REVISION: A DATE: 01JUL93 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: BUTNLM.EXE NOVELL PRODUCT and VERSION: NetWare Btrieve NLM 5.15 ABSTRACT: This file contains BUTIL.NLM v5.15a for use with NetWare's BTRIEVE.NLM. The BUTIL NLM is a utility that performs most functions of the DOS BUTIL.EXE _________________________________________________________________ DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. _________________________________________________________________ Self-Extracting File Name: BUTNLM.EXE Files Included Size Date Time BUTNLM.TXT (This File) BUTIL.NLM 64489 7-09-91 10:10a README FOR BTRIEVE's BUTIL (NLM) v5.15a RELEASE This README file of BUTNLM.EXE accompanies the released version of BUTIL NLM v5.15a. The following files are included: ** May 9, 1991 ** Version 5.15a BUTIL.NLM is a utility which contains a set of commands that allow Btrieve users to create, maintain and recover Btrieve files at the server. BUTIL.NLM supports 10 of the commands that are implemented in BUTIL.EXE. The following is a list of commands that are available and a short description of each: * Clone command format: Load Butil -Clone [-o] The Clone command creates a new, empty Btrieve file with the same file structure as an existing file. * Copy command format: Load Butil -Copy [-o [ -O ]] The Copy command copies the contents of one Btrieve file to another. * Create command format: Load Butil -Create The Create command builds an empty Btrieve file using the structure specified in a description file. * Drop command format: Load Butil -Drop [-o] The Drop command is used to remove a supplemental index from a Btrieve file. * Index command format: Load Butil -Index [-o] The Index command builds an external index file based on a field that had not been specified as a key before. * Load command format: Load Butil -Load [-o] The Load command allows you to insert records from a sequential file into a Btrieve file. * Recover command format: Load Butil -Recover [-o] The Recover command reads records from a Btrieve file and writes them to a sequential file that is compatible with the Load command. * Save command format: Load Butil -Save [ | ] [-o] The Save command allows you to retrieve records from a Btrieve file by a specified index path, and creates a sequential file that is compatible with the Load command. * Sindex command format: Load Butil -Sindex [-o] The Sindex command creates a supplemental index for an existing Btrieve file. * Stat command format: Load Butil -Stat [-o] The Stat command returns characteristics and statistics about a Btrieve file. The command line: Load Butil -Command Parameters loads the NLM, executes the operation specified and unloads the NLM. You can either execute these commands from the console prompt, or enter them into a NetWare Command File(NCF). It is important to specify the complete path, including the volume name on the command line or in the NCF file. BUTIL.NLM will return non-zero status (unsuccessful operation), when a complete path is not specified. For example, the following command will create a file called MyFile.Btr in the Sys: volume under the Test subdirectory using description file MyFile.des: Load Butil -create Sys:\Test\MyFile.btr Sys:\Test\MyFile.des If a NCF file is used to execute BUTIL operations, the file can only contain one BUTIL command. In other words, to recover a damaged Btrieve file using Recover and Load commands, you need to have two NCF files; one for the Recover command and one for the Load command. This is because the first operation loads the NLM and executes the command. Meanwhile, the second BUTIL operation tries to load the NLM while the first one is still running. In this case, the second attempt to load the BUTIL NLM will result with the error "This module is already loaded and cannot be loaded more than once". There is no advantage for running BUTIL.NLM compared to BUTIL.EXE in many cases, such as Create, Stat and Drop. It might even be more convenient to run BUTIL at the workstation for most of the operations. However, it is much faster to recover files using the NLM version. The BUTIL.NLM runs under the following combinations: 1. Netware version 3.10 with Btrieve version 5.10. 2. Netware version 3.10 with Btrieve version 5.15. 3. Netware version 3.11 with Btrieve version 5.15. ÿ